Documentation for this PR has been generated and is available at: https://n0-computer.github.io/iroh-blobs/pr/94/docs/iroh_blobs/

Last updated: 2025-07-03T11:00:54Z

I don't really like add_protected, but I also don't have a better solution right now. Maybe we add it and then strongly discourage using it or mark it as unstable somehow?

After thinking about this a bit, the best thing to do in the long term would be for docs to store small blobs inline and just bypass blobs entirely, then just use blobs for large blobs. The downside is of course that the small blobs stored in docs won't be available via the blobs API, but I think that is quite reasonable.

For large blobs, docs would then use the normal mechanisms (tags and temp tags) to keep the blobs alive, and the overhead would be acceptable because this would be only for a small subset of blobs.